package com.guomei.service.exam;

import com.guomei.bean.exam.domain.ExamQuestion;
import com.guomei.utils.Result;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

/**
 * 考试题目服务接口
 */
public interface ExamQuestionService {
    /**
     * 根据ID查询题目
     * @param id 题目ID
     * @return 题目信息
     */
    ExamQuestion getById(Long id);

    /**
     * 查询所有题目
     * @return 题目列表
     */
    List<ExamQuestion> getAll();

    /**
     * 根据条件查询题目
     * @param examQuestion 查询条件
     * @return 题目列表
     */
    Result<?> getByCondition(ExamQuestion examQuestion);

    /**
     * 新增题目
     * @param examQuestion 题目信息
     * @return 新增结果
     */
    boolean save(ExamQuestion examQuestion);

    /**
     * 批量新增题目
     * @param examQuestions 题目列表
     * @return 新增结果
     */
    boolean batchSave(List<ExamQuestion> examQuestions);

    /**
     * 更新题目
     * @param examQuestion 题目信息
     * @return 更新结果
     */
    boolean update(ExamQuestion examQuestion);

    /**
     * 根据ID删除题目
     * @param id 题目ID
     * @return 删除结果
     */
    boolean removeById(Long id);

    /**
     * 批量删除题目
     * @param ids 题目ID列表
     * @return 删除结果
     */
    boolean batchRemove(List<Long> ids);

    /**
     * 根据考试ID查询题目列表
     * @param examId 考试ID
     * @return 题目列表
     */
    List<ExamQuestion> getByExamId(Long examId);

    /**
     * 根据考试ID和题目类型查询题目列表
     * @param examId 考试ID
     * @param questionType 题目类型
     * @return 题目列表
     */
    List<ExamQuestion> getByExamIdAndType(Long examId, Short questionType);

    /**
     * 根据考试ID删除所有题目
     * @param examId 考试ID
     * @return 删除结果
     */
    boolean removeByExamId(Long examId);

    /**
     * 通过Excel文件导入题目（第一个模板 - 客观题）
     * @param examId 考试ID
     * @param file Excel文件
     * @return 导入结果
     */
    Result<?> importFromExcelFile(Long examId, MultipartFile file);

    /**
     * 通过Excel文件导入主观题（第二个模板 - 主观题）
     * @param examId 考试ID
     * @param file Excel文件
     * @return 导入结果
     */
    Result<?> importSubjectiveFromExcelFile(Long examId, MultipartFile file);

    /**
     * 验证题目分数是否合法
     * @param examId 考试ID
     * @param questions 题目列表
     * @return 验证结果
     */
    Result<?> validateQuestionScores(Long examId, List<ExamQuestion> questions, Integer QuestionType);
}
